<?php
# ***** BEGIN LICENSE BLOCK *****
# This file is part of "myWiWall".
# Copyright (c) 2007-2008 CRP Henri Tudor and contributors.
# All rights reserved.
#
# "myWiWall" is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 2 as published by
# the Free Software Foundation.
# 
# "myWiWall" is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with "myWiWall"; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
# ***** END LICENSE BLOCK *****

?>
<div class="section">
<h1><?php echo __("Online help"); ?></h1>
<h2 id="table-of-content">Table des matières</h2>
<ul id="help_toc">
	<li><a href="#before-reading" title="Avant propos">Avant-propos</a></li>
	<li><a href="#login" title="L'écran de connexion">L'écran de connexion</a></li>
	<li><a href="#widget-wall" title="Le mur de widgets">Le mur de widgets</a>
		<ul>
			<li><a href="#add-widget" title="L'ajout de widgets">L'ajout de widgets</a></li>
			<li><a href="#control-panel" title="Le panneau de contrôle">Le panneau de contrôle</a>
				<ul>
					<li><a href="#access-help" title="Accéder à l'aide en ligne">Accéder à l'aide en ligne</a></li>
					<li><a href="#logoff" title="Se déconnecter du portail">Se déconnecter du portail</a></li>
					<li><a href="#access-admin" title="Accéder à l'administration du portail">Accéder à l'administration du portail</a></li>
				</ul>
			</li>
			<li><a href="#widgets-zone" title="La zone des widgets">La zone des widgets</a>
				<ul>
					<li><a href="#organization" title="Organisation des widgets">Organisation des widgets</a></li>
					<li><a href="#drag-drop" title="Déplacement des widgets">Déplacement des widgets</a></li>
				</ul>
			</li>
		</ul>
	</li>
	<li><a href="#widgets" title="Les widgets">Les widgets</a>
		<ul>
			<li><a href="#window-system" title="Le système de fenêtrage">Le système de fenêtrage</a></li>
			<li><a href="#action-buttons" title="Les boutons d'action">Les boutons d'actions</a></li>
			<li><a href="#widget-config" title="Configuration des widgets">Configuration des widgets</a></li>
		</ul>
	</li>
</ul>

<h2 id="before-reading">Avant-propos</h2>
<p>
	Cette documentation en ligne est destinée aux utilisateurs finaux du portail
	myWiWall. Les mots ou groupes de mots apparaissant sous forme de liens hyper-texte 
	vous permettent de naviguer vers une définition plus détailée d'un concept. 
	N'hésitez pas à les utiliser si un terme ne vous est pas familié, pour ensuite 
	continuer votre apprentissage.
</p>
<p>
	Pour tout problème ou remarque constructive, n'hésitez pas à envoyer un courrier 
	électronique à jerome.bogaerts at tudor dot lu.
</p>
<p>
	Toute l'équipe du portail MyWiWall vous souhaite une agréable lecture.
</p>

<h2 id="login">L'écran de connexion</h2>
<p>
	Pour accéder à votre espace personnel du portail, vous devez avant tout 
	vous authentifier auprès du système. Pour ce faire, un formulaire de 
	déconnexion est à votre disposition. Il est composé de deux champs de texte 
	et d'un bouton qui sont respectivement dédié à : saisir votre identifiant, 
	saisir votre mot de passer et enfin, valider la connexion.
</p>
<p>
	Lorsque vos identifiants sont correctement approuvés par le système, vous êtes 
	redirigés automatiquement vers le mur de widgets. Dans le cas contraire, un message 
	d'erreur vous invitant à resaisir vos identifiants est affiché au dessus du 
	formulaire d'authentification. 
</p>

<h2 id="widget-wall">Le mur de widgets</h2>
<p>
	L'écran principal du portail est ce que nous appellons le "Mur de Widgets". 
	C'est sur ce dernier que les <a href="#widgets">widgets</a> que vous choisirez d'utiliser seront affichées.
</p>
<p>
	L'écran "Mur de Widgets" est divisé en 3 parties distinctes : "<a href="#add-widget">L'ajout de widgets</a>", 
	"<a href="#control-panel">Le panneau de contrôle</a>" et la "<a href="#widgets-zone">zone des widgets</a>" qui vous sont décrites dans les 
	sections suivantes de l'aide en ligne du portail.
	
	<img class="capture" src="../../views/common/onlinehelp/img/capture-interface.png"/>
	<span class="legend">Le mur de widget avec le l' "ajout de widgets"(1), le "paneau de contrôle"(2) et la "zone des widgets"(3).</span>
</p>

<h3 id="add-widget">L'ajout de widgets</h3>
<p>
	Dans le coin supérieur droit de votre écran se trouve l'outil "Ajouter des widgets". 
	Pour ajouter un widget à votre mur de widgets, cliquez sur le bouton "Ajouter des widgets".
	Les widgets disponibles, classés par catégories sont alors affichez. Pour ajouter un widget, cliquez dessus.
	Notez que si le widget préalablement sélectionné se trouve déjà dans votre zone de widgets, un message vous en avertira et l'ajout 
	ne sera pas effectif. Après avoir clické sur la widget, vous la retrouverez  
	prêt à l'emploi dans la zone des widgets.
	
	<img class="capture" src="../../views/common/onlinehelp/img/capture-addwidget.png"/>
	<span class="legend">Le menu déroulant de sélection des widgets.</span>
</p>
<p>
	Il existe un type de widgets spécial utilisant le mécanisme d'"Authentification automatique". 
	Ces <a href="#widgets">widgets</a> doivent parfois transmettre des informations personnelles vers des serveurs sécurisés, 
	pour assurer les services que vous pouvez consommer au travers d'elles. Dès lors, si vous ajoutez un 
	tel type de widget à votre mur, un message vous en avertira et vous pourrez à ce moment accepter 
	ou refuser d'utiliser le widget.
</p>

<h3 id="control-panel">Le panneau de contrôle</h3>
<p>
	Le panneau de contrôle reprend votre identifiant, et une série d'actions que vous pouvez 
	entreprendre sur le portail. Ces actions sont par défaut : "Mes préférences", 
	"Aide en ligne", "Déconnexion", et enfin, si vous êtes administrateur du portail, 
	"Administration".
	
	<img class="capture" src="../../views/common/onlinehelp/img/capture-controlpanel.png"/>
	<span class="legend">Le panneau de contrôle situé dans le coin supérieur droit du mur de widgets.</span>
</p>

<h4 id="access-help">Accéder à l'aide en ligne</h4>
<p>
	En cliquant sur l'hyper-lien "Aaide en ligne", vous serez redirigé vers l'aide en ligne du portail.
</p>
<h4 id="logoff">Se déconnecter du portail</h4>
<p>
	Cliquer sur l'hyper-lien "Déconnexion" a pour effet de clôturer la session utilisateur en cours. 
	Bien evidemment, toutes les actions que vous aurez précédemment effectué sur le portail seront 
	sauvegardées de manière persistante.
</p>

<h4 id="access-admin">Accéder à l'administration du portail</h4>
<p>
	Cliquer sur l'hyper-lien "Administration" vous renverra dans la section d'administration du portail, si et
	seulement si vous êtes connecté en tant qu'administrateur du portail.
</p>

<h3 id="widgets-zone">La zone des widgets</h3>
<p>
	La zone des widgets est le point central du portail. C'est dans celle-ci que tous vous pourrez 
	utiliser et organiser votre panoplie de <a href="#widgets">widgets</a>.
</p>

<h4 id="organization">Organisation des widgets</h4>
<p>
	La zone des widgets est organisée en 3 colonnes qui peuvent chacune contenir un nombre indéterminé de <a href="#widgets">widgets</a>. 
	Les colonnes de widgets sont indépendantes les unes des autres, et leur taille s'adaptent automatiquement 
	en fonction de la taille des widgets qu'elles contiennent. Par cette organisation en colonne, vos widgets 
	sont organisées de manière efficace, telle une mosaique d'applications prêtes à l'emploi.
</p>

<h4 id="drag-drop">Déplacement des widgets</h4>
<p>
	Le déplacement des widgets dans la zone des widgets est facile est intuitive. Pour déplacer un widget, 
	l'application vous propose d'utiliser le concept de "Glisser, Déposer". Pour ce faire, cliquez sur 
	la barre de titre du widget, déplacez celui-ci juqu'à l'emplacement souhaité dans la zone des widgets.
	Lorsque la position marquée d'un trait discontinu vous convient, relâchez le bouton de la souris. 
	N'hésitez pas à glisser les <a href="#widgets">widgets</a> vers des emplacements déjà occupés. En effet, vous 
	noterez que les widgets se réorganiseront automatiquement pour faire place à la widget déplacée.
	
	<img class="capture" src="../../views/common/onlinehelp/img/capture-dragdrop.png"/>
	<span class="legend">Exemple de déplacement d'un widget d'une colonne à l'autre grâce à la technique du "Glisser, Déposer".</span>
</p>

<h2 id="widgets">Les widgets</h2>
<p>
	Les widgets ou gadgets, et dans le cas du portail MyWiWall, les web widgets, sont des applications 
	interactives réalisées dans le but d'afficher ou mettre à jour des données sur l'Internet, qu'un 
	utilisateur peut utiliser simplement au travers d'un document Web.
</p>
<p>
	Il existe de très nombreux web widgets, que les utilisateurs peuvent très simplement utiliser 
	au travers de moteurs de widgets, tel que le portail MyWiWall. Ces web widgets fournissent aux 
	utilisateurs un accès à des services en ligne comme la météo en temps réel, le cours de la bourse, 
	la lecture de flux RSS, et bien d'autres encore.
</p>
<p>
	Dans MyWiWall, les widgets sont affichés dans des fenêtres, telles qu'on peut les voir dans des systèmes 
	d'exploitation tels que GNU Linux ou Microsoft Windows. Ces fenêtres sont composées d'une barre de titre, 
	et de boutons d'actions permettant notamment de <a href="#widget-config">configurer</a>, 
	<a href="#action-buttons">fermer</a>, <a href="#action-buttons">minimiser</a> ou <a href="#action-buttons">maximiser</a> un widget.
</p>
<p>
	Les widgets peuvent être organisés à l'écran pour former des interfaces utilisateurs composites qui 
	permettront aux utilisateurs d'achever des buts métiers à granularité plus ou moins fine, ou 
	tout simplement apprendre, se divertir, ...
</p>

<h3 id="window-system">Le système de fenêtrage</h3>
<p>
	Les widgets sont affichées sous forme de fenêtres. Ces dernières contiennent une barre de 
	titre affichant le titre du <a href="#widgets">widget</a>, une icône éventuelle, et des boutons d'action. Le 
	système de fenêtrage vous rappellera sans nul doute votre système d'exploitation favoris, 
	ce qui vous permettra de trouver vos marques facilement dans le portail MyWiWall.
	
	<img class="capture" src="../../views/common/onlinehelp/img/capture-widget.png"/>
	<span class="legend">Un widget "lecteur de flux RSS" affiché sous forme de fenêtre dans myWiWall.</span>
</p>

<h3 id="action-buttons">Les boutons d'actions</h3>
<p>
	Par défaut, la fenêtre accueillant un widget arbore différents boutons d'action.
	<ul class="iconified_list">
		<li>
			<img class="caputre" src="../../views/common/onlinehelp/img/icon-close.png"/>
			Le bouton "Fermer" vous permet de retirer le widget de votre mur de widget.
		</li>
		<li>
			<img class="caputre" src="../../views/common/onlinehelp/img/icon-minimize.png"/>
			<img class="caputre" src="../../views/common/onlinehelp/img/icon-maximize.png"/>
			Le bouton "Minimiser/Maximiser" permet de minimiser ou maximiser la taille de la fenêtre contenant le <a href="#widgets">widget</a>. 
			Si la fenêtre contenant l'application du widget est ouverte, cliquer sur le bouton aura pour effet de réduire 
			la hauteur de la fenêtre pour ne plus voir que la barre de titre. Si la fenêtre contenant le widget est minimisée, 
			un click sur le bouton lui rendra sa taille originale.
		</li>
		<li>
			<img class="caputre" src="../../views/common/onlinehelp/img/icon-mail.png"/>
			Le bouton "Envoyer un email à l'auteur" vous permet d'envoyer un email à l'auteur du widget.
		</li>
		<li>
			<img class="caputre" src="../../views/common/onlinehelp/img/icon-edit.png"/>
			Le bouton "Edit" offre l'accès à l'espace de configuration du widget. Reportez vous à la section adéquate 
			de cette documentation en ligne pour plus de détail.
		</li>
	</ul>
</p>
<p>
	En plus de ces 4 boutons d'actions arborés par chaque fenêtre abritant un widget, s'ajoute un paramètre dépendant 
	de l'implémentation du widget. Si activé par l'auteur du widget :
	<ul class="iconified_list">
		<li>
			<img class="caputre" src="../../views/common/onlinehelp/img/icon-close.png"/>
			Le bouton "Adresse alternative" permet d'accéder à une page Web alternative au widget. 
			Une fois le bouton cliqué, votre navigateur chargera dans une nouvelle fenêtre cette adresse 
			alternative qui pourrait héberger, par exemple, une version de l'application plus complète, ou 
			encore des informations sur le widget sous la forme d'une foire aux questions.
		</li>
	</ul>
</p>

<h3 id="widget-config">Configuration des widgets</h3>
<p>
	En cliquant sur le bouton Edit dans la barre de titre d'un widget, vous accédez 
	à l'espace de configuration de ce dernier. Si le widget est paramètrable, une 
	série de paramètres de configuration sont affichés. Rentrez les données adéquates 
	selon l'implémentation du widget et cliquez sur le bouton "Sauver". Le système de 
	configuration des widgets est réactif et intelligent. Si une donnée entrée pour un paramètre 
	n'est pas compatible avec ce dernier, vous en serez automatiquement averti, et vous serez 
	invité à rentrer une valeur plus appropriée.
	
	<img class="capture" src="../../views/common/onlinehelp/img/capture-preferences.png"/>
	<span class="legend">Appuyer sur le bouton d'action "Edit" vous permet de configurer votre widget.</span>
</p>
<p>
	Vous noterez également la présence d'un champs de saisie nommé "Tags". Celui-ci vous permet 
	d'associer des mots-clé à vos widgets. N'hésitez pas à les utiliser, car ils seront 
	ensuite partagés avec les autres utilisateurs du portail par le biais du widget "TagCloud", 
	fourni en standard avec MyWiWall, qui offre aux utilisateurs l'opportunité de rechercher 
	par mot-clé des widgets qui pourraient les intéresser.
</p>
</div>